home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 12 / vpic40.zip / VPIC.DOC < prev    next >
Text File  |  1991-02-18  |  49KB  |  992 lines
  1.                          VPIC USERS MANUAL
  2.                A Picture File Viewing/Conversion Program
  3.         (C) Copyright 1990 Bob Montgomery, All Rights Reserved
  4.                         by Bob Montgomery
  5.                           CIS 73357,3140
  6.  
  7. INTRODUCTION
  8. Background
  9.  
  10. The original program was called VGIF, reflecting its ability to view only GIF
  11. files. When the program evolved to include other paint file formats, its name
  12. was changed to VPIC. A configuration program (CVPIC.EXE) is also supplied to
  13. configure VPIC to your VGA board. VPIC ver 4.0 implements all of the GIF89a
  14. features. See the revision history in Appendix A for latest additions and bug
  15. fixes.
  16.  
  17. Print VPIC.TXT at 17 chars/inch and 8 lines/inch for a handy reference card.
  18. Look at the section titled 'How Vpic Operates' for an explanation of the
  19. differences between VPIC and other viewers, and the advantages and
  20. disadvantages of both types.
  21.  
  22. IMPORTANT: VPIC requires DOS 2.0 or up to run from current directory, or DOS 3.0
  23. up to run from anywhere. You must configure VPIC for your graphics board using
  24. CVPIC or CONFIG (unless you have an Orchid Designer VGA with 512 K).
  25.  
  26. The Graphics Interchange Format (GIF) is a Service Mark owned by Compuserve
  27. Incorporated. For further information, please contact:
  28.     Compuserve incorporated, Graphics Technology Department,
  29.     5000 Arlington Center Boulevard, Columbus, Ohio 43220, USA
  30.  
  31. GENERAL FEATURES
  32. VPIC is a file viewer for EGA, MCGA, VGA and SuperVGA, and has the following
  33. features:
  34.   *  Views the following file formats in EGA, MCGA, VGA, or SuperVGA:
  35.      1. Dr. Halo CUT files (with PAL if present). Not Dr. Halo PIC files.
  36.      2. GIF87a and GIF89a files.
  37.      3. Deluxe Paint LBM (or IFF) files, regular and enhanced.
  38.      4. MAC files.
  39.      5. Pictor/PC Paint PIC files.
  40.      6. ZSoft PCX files (including 256 color files).
  41.      7. ColorRIX/EGA Paint SCx files.
  42.      8. Targa 8 thru 32 TGA files, comressed or uncompressed.
  43.      9. Binary Image Files (BIF) from B&W image capture boards.
  44.  
  45.   *  Saves current image to any of the above formats (except MAC, FRA, BIF, and
  46.      IFF) in the current mode (EGA, MCGA, or VGA). Also uncompresses TGA files,
  47.      and converts a color picture to a 64 grey shade image (in VGA mode).
  48.  
  49.   *  Saves current image to GIF in regular, interlaced, inverted, mirrored,
  50.      or rotated 90 degrees CW or CCW. Great for scans.
  51.  
  52.   *  Configurable for display boards using Tseng3000 and Tseng4000, Paradise,
  53.      Everex, ATI, Trident, C&T, Video 7, Genoa, Zymos, or Ahead (B) VGA chips
  54.      (see configuring VPIC below); the Ahead A chip used on some early boards is
  55.      not supported. Configuration program automates the configuration process.
  56.  
  57.   *  /R option allows an application program to show a file and regain control
  58.      without changing the screen mode.
  59.  
  60.   *  Viewing mode can be manually selected or auto selected from menu.
  61.  
  62.   *  Allows you to specifiy a new path from the menu with the [F9] key. Also
  63.      updates menu when files are added or deleted.
  64.  
  65.   *  Very fast GIF decoding.
  66.  
  67.   MENU FEATURES:
  68.   *  Mark/unmark files for viewing with [SPACEBAR].
  69.   *  Menu text color setable in configuration file.
  70.   *  [F1] gives help.
  71.   *  [F2] shows marked files like a slideshow.
  72.   *  [F3] gives file size and colors.
  73.   *  [F4] toggles between EGA and VGA mode.
  74.   *  [F5/F6] decrease/increase default resolution.
  75.   *  [F7] Locks current resolution, or selects auto resolution mode.
  76.   *  [F8] Makes multiple GIF images pause for a keypress.
  77.   *  [F9] prompts for new path.
  78.   *  [F10] shows current path for files.
  79.   *  Shows marked files singly or like a slide show.
  80.   *  Handles up to 500 files.
  81. ==============================================================================
  82.   VIEWING FEATURES
  83.   *  Help while viewing with / or ? key.
  84.   *  Shows filename while decoding, and [ESC] aborts decoding.
  85.   *  Allows deleting a file (with query) with the [Alt-X] key.
  86.   *  Allows adjustment of picture color and VGA contrast and brightness.
  87.   *  Allows saving the current image as a GIF (many options), PC Paint or
  88.      Pictor, ZSoft PCX, ColoRIX or EGA Paint, Targa 16, Dr. Halo CUT, and
  89.      Deluxe Paint II formats in EGA, MCGA, or VGA.
  90. =============================================================================
  91. RUNNING VPIC
  92. Command Format: vpic [[path]filespec][/a][/e][/r][/c][/w][/?].
  93.   *  The default path is the current directory, and the default extensions are
  94.      CUT, GIF, IFF, LBM, MAC, PIC, PCX, SCx, and TGA.
  95.   *  The /a option starts VPIC in Auto resolution select mode.
  96.   *  The /b option causes VPIC to beep after displaying a file except in slide
  97.      mode or /r.
  98.   *  The /c option gives the current configuration; see 6 below.
  99.   *  The /e option forces EGA mode, to use extended 16 color modes; see 5 below.
  100.   *  The /h option allows the viewing of hidden files.
  101.   *  The /r option returns control to a calling program; see 4 below.
  102.   *  The /w option wait for a keypress after each image in a multi_image GIF
  103.      file.
  104.   *  The /? option gives a help screen.
  105.   *  If filespec is a filename, the single file will be shown (the default
  106.      extension is GIF).
  107.   *  If path\filespec is a directory, a menu of all viewable files in that
  108.      directory will appear. Otherwise all files meeting the filespec will
  109.      appear. For example, [vpic d:\pics\*.pcx] would give a menu of all PCX
  110.      files in the PICS directory of drive D, while [vpic d:\pics] would give a
  111.      menu of all viewable files in the PICS directory of drive D.
  112.   *  Options and filespec may be entered in any order.
  113.  
  114. EXAMPLES OF VPIC COMMANDS
  115.     1. VPIC [path\]filename[.ext] shows the file specified. The default path is
  116.        the current directory, and the default extension is GIF.
  117.  
  118.     2. VPIC [path\][filespec] to get a menu of all files in the specified path
  119.        meeting filespec (may contain wildcards). The default path is the current
  120.        directory, and the default filespec is any of the viewable files; just
  121.        entering VPIC will give a menu of all viewable files in the current
  122.        directory. Shows whether VGA or EGA and modes supported in upper left
  123.        corner. If Path contains . or .., a filespec must be given (may contain
  124.        wildcards). Thus ..\*.* would give a menu of all viewable files in the
  125.        parent of the current directory.
  126.  
  127.     3. VPIC /@[path\]slidefile[.ext]  to do a slide show from commands in a
  128.        slidefile. The default path is the current directory, and the default
  129.        slidefile extension is SLD. The commands are placed on seperate lines,
  130.        and consist of either:
  131.        a. A filename (GIF extension assumed) and optional:
  132.           1. Display mode (number) and/or
  133.           2. Animate command (a followed by optional number with no spaces).
  134.        b. A delay (viewing time) spec of the form  d n (space required) where n
  135.           is the desired viewing time in seconds.
  136.  
  137.        The maximum number of files is 100. The number following the optional 'a'
  138.        is the number of vertical retraces between animation steps. The default
  139.        value is 8 (if no number follows the 'a'). The mode is explained below.
  140.  
  141.        The default viewing time is 5 seconds if no delay spec is given; a delay
  142.        spec applies to all files following in the slide file until changed. The
  143.        first slide is not delayed the first time it is shown. The default
  144.        viewing mode is whatever would look best.
  145.  
  146.        VPIC understands comments preceded by a semicolon, blank or comment
  147.        lines, and extra spaces. For example, the following slide file contents
  148.        are understood by VPIC, but not recommended:
  149.  
  150.        d 20         ;Delay for file1.gif & file2.pcx is 20 seconds.
  151.        file1  1     ;First file in slideshow. File1.gif using mode 1.
  152.           file2.pcx ;This is a ZSoft filename with leading spaces.
  153.           ;This is a comment line with leading spaces, next is a blank line.
  154.  
  155.        d 10         ;File3 is delayed 10 seconds.
  156.        file3 a30    ;Show file 3, animate at 1 shift every 30 vertical retraces.
  157.           d      15 ;15 second delay file4.gif. Has leading & separator spaces.
  158.        file4        ;Show file4.gif, then do a 20 second delay for file1.gif.
  159.  
  160.        To end a slide show after the current picture, press any key. [ESC] ends
  161.        it immediately.
  162.  
  163.        The mode requires a little further explanation. In the above slide file,
  164.        it says to use mode 1 with file1. Modes 1 thru 10 are the VGA (256 color)
  165.        modes, and modes 11 thru 20 are EGA (16 color) modes called out in the
  166.        configuration file. Most display boards only have a few of each type. The
  167.        Orchid Designer has 4 VGA modes and 4 EGA modes in the configuration file.
  168.  
  169.        The VGA modes are                  ║ The EGA modes are
  170.         1. 320x200x256     2. 640x350x256 ║ 11. 640x350x16     12. 640x480x16
  171.         3. 640x480x256     4. 800x600x256 ║ 13. 800x600x16     14. 1024x768x16
  172.  
  173.        Thus, the slide file says to show file1 in the 320x200x256 mode, and show
  174.        all the others in the default modes (whatever looks best). The CONFIG
  175.        program lists the modes and their corresponding mode numbers for you if
  176.        you highlight the configuration file for your board.
  177.  
  178.     4. VPIC /r shows the file and then returns to DOS (or a calling application
  179.        program) with the picture still on the screen in EGA/VGA. It is not
  180.        necessary to change the video mode between viewing each file, but it is
  181.        up to the calling program to reset text mode (mode 3) after all viewing
  182.        is done. The /e and /a switches are valid in this mode.
  183.  
  184.     5. VPIC /e forces and EGA display with VGA to use extended EGA modes.
  185.  
  186.     6. VPIC /c prints the current configuration of vpic. You can configure VPIC
  187.        to your display board using the CVPIC program and a text configuration
  188.        file describing your board.
  189.  
  190.     7. VPIC /a starts VPIC in auto resolution mode.
  191.  
  192.     8. VPIV /b causes VPIC to beep after a file has been fully decoded. Lets you
  193.        know when the viewing options are available. Doesn't beep in slide mode
  194.        or when using the /r option.
  195.  
  196.     9. VPIC /h allows VPIC to find and display hidden files. Great for those
  197.        R or X rated files you don't want to be normally accessible. This option
  198.        doesn't appear on the help screen.
  199.  
  200.     10. VPIC /?  gives a help screen.
  201.  
  202. CONFIGURING VPIC
  203. VPIC must be configured to run correctly with your display board. The
  204. configuration process tells VPIC:
  205.     1. The title you want for the menu.
  206.     2. What VGA chip you have, so it can use the proper bank switching routine.
  207.     3. How much memory you have (in 64K banks).
  208.     4. The menu color you want.
  209.     5. How to set the various modes you want to use.
  210.  
  211. There are numerous configuration files which come with VPIC, but there are so
  212. many boards out there that I can't list all of them. If a configuration file for
  213. your board isn't supplied, copy the closest one to a new filename (with
  214. extension .cfg) and use a text editor to modify it for your board. To configure
  215. VPIC, make sure that VPIC, CVPIC, CONFIG, and all the .CFG files are in the
  216. current directory.
  217.  
  218. If you aren't sure which VGA chip your board uses, you can remove the display
  219. board and look at the label on the large chip with leads coming out all for
  220. sides. Sometimes, you can tell without removing the board by using DEBUG (or
  221. Turbo Debugger, Codeview, or any debugger) and 'dumping' the contents of display
  222. BIOS. To do this, enter DEBUG at the DOS prompt and you will get a - prompt.
  223. Then enter d C000:0 to display the first part of display BIOS. You may recognize
  224. the chip manufacturers name here, such as Trident, Tseng, Paradise, etc. To exit
  225. DEBUG, just enter q.
  226.  
  227. MENU CONFIGURATION
  228. By running the CONFIG program, VPIC can be configured from a menu. CONFIG lists
  229. all the configuration files (with a .cfg extension) in the current directory,
  230. and shows you the contents of each as you move around the list using the cursor
  231. keys. ESCape aborts the CONFIG program without changing VPIC, and ENTER
  232. configures VPIC for the highlighted file. Pressing a letter key jumps to next
  233. filename starting with that letter (or number).
  234.  
  235. MANUAL CONFIGURATION
  236. You can use CVPIC to configure VPIC manually by entering
  237.          CVPIC [config_file[.ext]]
  238.     where the default configuration file is VPIC.CFG (which is for the Orchid
  239.     Designer VGA board with white menu text color) and the default extension is
  240.     .CFG.
  241.  
  242. THE CONFIGURATION FILES
  243. The default configuration of VPIC is for the Orchid Designer VGA card with
  244. 512K of display memory. If you have just EGA, you should use the EGA.CFG
  245. file. If you have plain vanilla VGA (ps/2 and model 50 with modes 10h, 12h, and
  246. 13h), use VGA.CFG. The meaning of each field is given in the various
  247. configuration files. You can make your own custom config file, or use one of the
  248. configuration files supplied. VPIC supports most of the popular boards using the
  249. Tseng (ET3000 and ET4000), Paradise, Everex, ATI, Trident (TVGA 8800 and
  250. TVGA 8900), C_T, Video 7, Ahead (B chip), Zymos (TVGA 8900), or Genoa VGA chips.
  251.  
  252. CONFIGURATION FILE (.CFG) FORMAT
  253. CVPIC ignores leading spaces in the file, and all characters after a semicolon
  254. are considered comments and ignored. The .CFG file contains the following lines,
  255. which can be up to 150 characters in length each:
  256.  
  257.     1. Board name, which will appear in the VPIC menu. This is user defineable,
  258.        and could be something like 'Joe's VGA Board'.
  259.  
  260.     2. VGA CHIP set, and should be TSENG, TSENG4, PARADISE, EVEREX, ATI, C_T,
  261.        VIDEO7, TRIDENT, AHEADB, GENOA, ZYMOS, or GENERIC presently; upper or
  262.        lower case is OK.
  263.  
  264.        TSENG - The TSENG is for the ET3000 chip and the TSENG4 is for the ET4000
  265.        chip from Tseng Labs.
  266.  
  267.        TRIDENT - The ZYMOS chip is really a Trident 8900, and you should use
  268.        this chip name in the config file if you have the Trident 8900 chip in
  269.        your VGA board and want to use normal 64 bank switching. The TRIDENT VGA
  270.        chip in the config file tells VPIC to use the older 128K bank switching
  271.        for the 8800 Trident chip. Either should work for the Trident 8900 chip.
  272.  
  273.     3. The number of 64K banks of display ram usable for pictures (1 for
  274.        standard VGA, 4 for 256K, 8 for 512K, 16 for 1M).
  275.  
  276.     4. Menu text color; 0 thru 7 corresponds to black, blue, green, aqua, red,
  277.        violet, brown, and white. For example, 4 would be red text.
  278.  
  279.     5 thru n. The following lines describe the modes supported by the board.
  280.       Each line is of the form: F1 F2 AX BX CX DX W H C  where:
  281.         *  F1 = VGA (256 color) mode flag.
  282.         *  F2 = 256K colors to choose from (as in mode 12h, 640x480x16) flag.
  283.         *  AX,BX,CX,DX  register values used to set this mode. Preceeding the
  284.            numbers by 0x indicates hex; ie., 0x10 = 16.
  285.         *  W, H, C  are width, height, colors in this mode.
  286.       All the VGA (256 color) modes should be grouped first, followed by the EGA
  287.       (16 color) modes.
  288.  
  289. COMMANDS IN MENU MODE
  290. Keyboard Commands in Menu Mode
  291.  
  292. 1.  The [up], [down], [right], and [left] arrow keys move the cursor around the
  293.     menu of files. [PgDn/PgUp] goto next/previous page. Pressing a key goes to
  294.     next file starting with this character.
  295.  
  296. 2.  Pressing the [SPACEBAR] marks a file for viewing or slides, and moves to the
  297.     next file; it will also unmark a previously marked file.
  298.  
  299. 3.  Pressing [ENTER] will display the marked files in the order they were
  300.     marked. If no files were marked, pressing enter displays the file at the
  301.     cursor.
  302.  
  303. 4.  Pressing [F1] will bring up the help screen; any key will return to the
  304.     menu.
  305.  
  306. 5.  Pressing [F2] will do a slide show of marked files until a key is pressed.
  307.  
  308. 6.  Pressing [F3] will display the file size and colors on the next to last
  309.     line.
  310.  
  311. 7.  Pressing [F4] will toggle between VGA and EGA modes.
  312.  
  313. 8.  Pressing [F5/F6] will decrease/increase the default resolution for files
  314.     larger than 320x200 in VGA.
  315.  
  316. 9.  Pressing [F7] goes to LOCK, which forces the default resolution (above) no
  317.     matter what the file size. Pressing F7 again goes to AUTO, which
  318.     automatically selects the resolution to display the picture. Pressing F7
  319.     again goes back to to the normal default mode.
  320.  
  321. 10. Pressing [F8] toggles the wait mode, where VPIC waits for a keypress between
  322.     multiple images in a GIF file.
  323.  
  324. 11. [F9] prompts for a new path\filespec, and displays a menu of the files in
  325.     the new path meeting the filespec.
  326.  
  327.  
  328. 12. [Alt_X] prompts if you want to delete the file at the cursor. [Y] deletes
  329.     it, [N] or ESC doesn't, and all other keys are ignored.
  330.  
  331. 13. Pressing [ESC] ends the program and returns to DOS.
  332.  
  333. 14. Pressing [Ctrl-Break] or [Ctrl-C] will get you directly to DOS.
  334.  
  335. All other keys are ignored. If errors are encountered, an error message appears
  336. on the next to last line, and disappears when the cursor is moved. The menu
  337. title is the search spec.
  338.  
  339. KEYBOARD COMMANDS IN VIEWING MODE (except in slide mode)
  340.  
  341. *   The up/down arrow keys will scroll the picture if longer than the screen,
  342.     provided you have sufficient display memory. The [PgUp] and [PgDn] keys will
  343.     scroll by 10 lines. The Video 7 extended VGA boards do not supported writing
  344.     to non-displayed memory or scrolling pics larger than the screen, so this
  345.     function is disabled for these boards.
  346.  
  347. *   If the picture size is <= 1/2 the screen width, pressing [2] will give a
  348.     double size image (which may be scrollable) and pressing [1] will give the
  349.     normal size again. For VGA, the picture will be changed only in the
  350.     horizontal direction; this will unsquash some 320x400 pics so the aspect
  351.     ratio is correct.
  352.  
  353. *   Pressing [+] will increase the resolution (320x200 to 640x480, etc).
  354.  
  355. *   Pressing [-] will decrease the resolution; useful if 800x600 rolls.
  356.  
  357. *   Pressing [/] or [?] gives a help screen of commands available while viewing.
  358.  
  359.     Note: All the following conversion options check if the default filename is
  360.     present, and prompt for a new name if it is. They create a file on the
  361.     current drive and directory with the same dimensions as the file being
  362.     viewed, and let you know what is happening while the conversion proceeds. If
  363.     you screw up at the new filename prompt, hit [Ctrl-C] to escape immediately
  364.     to DOS; this will usually preserve a file you don't want to write over. The
  365.     safest bet is to view files in another directory, since the new file is
  366.     saved to the default directory, which is the drive and directory you ran
  367.     VPIC from. I put VPIC in my UTIL directory, and have my PATH set to include
  368.     UTIL, so I can run VPIC from any drive or directory.
  369.  
  370. *   Pressing [A] will 'animate' a picture by rotating the palette periodically.
  371.     This is especially effective on fractals, where large areas tend to be the
  372.     same color. Pressing [SPACEBAR] will pause the palette rotation, and
  373.     pressing [ENTER] will terminate it and return to the command mode. Thus, by
  374.     waiting for an especially nice pattern and then pressing [ENTER], the
  375.     pattern can be written to a file using the above file save commands.
  376.     Pressing [ESC] will return to the menu. The rate of palette rotation can be
  377.     increased/decresed with the up/down (slow) or PgUp/PgDn (fast) arrow keys.
  378.  
  379. *   Pressing [B] will convert a color VGA picture to a 64 shade gray picture.
  380.     The resulting image can be saved with the gray palette. Only works in VGA.
  381.  
  382. *   Pressing [C] will create a Dr. Halo CUT file with the same filename and
  383.     extension CUT. A palette file (.PAL) will also be created.
  384.  
  385. *   Pressing [E] will expand a Run Length Encoded (RLE) compressed Targa file. If
  386.     the file is not a Targa or is already uncompressed, this key does nothing.
  387.  
  388. *   Pressing [G, I, M, U, <, or >] will create a GIF file on the default drive,
  389.     and prompt for a new filename-the default extension is GIF. [G] is for
  390.     non-interlaced, and [I] is for interlaced, [M] is for mirror image, [U] is
  391.     for upside down (inverted), [<] is rotate image 90 degrees CCW, and [>] is
  392.     rotate image 90 degrees CW.
  393.  
  394. *   Pressing [P] will create a PC Paint or Pictor file. The default extension is
  395.     PIC, and for EGA it prompts for a PC Paint or Pictor file.
  396.  
  397. *   Pressing [R] will create a ColoRix file with the same filename and extension
  398.     SCx where x is a function of the screen size. If in EGA, will prompt if you
  399.     want an EGA Paint or ColoRix file.
  400.  
  401. *   Pressing [T] will create a Targa 16 file with the same filename and
  402.     extension TGA.
  403.  
  404. *   Pressing [Z] will create a ZSoft (PC Paintbrush) file with the same filename
  405.     and extension PCX. The file will be in whatever mode you are currently using
  406.     (EGA or VGA). The VGA palette will be correct for the latest version of PC
  407.     Paintbrush, which saves a VGA palette in the file.
  408.  
  409. *   [Alt_F] displays current filename momentarily.
  410.  
  411. *   Pressing [Alt-X] will prompt you to delete the current file. If you answer
  412.     [y] it will be deleted, [n] or ESC it won't, and all other keys are ignored.
  413.  
  414. *   Pressing [ENTER] will return to menu or DOS, or show next file for marked
  415.     menu mode.
  416.  
  417. *   Pressing [ESC] will end the display and return to the menu.
  418.  
  419. *   The following keys control the picture tone as follows:
  420.     [F1]       Decrease red content of picture.
  421.     [F2]       Increase red content of picture.
  422.     [F3]       Decrease green content of picture.
  423.     [F4]       Increase green content of picture.
  424.     [F5]       Decrease blue content of picture.
  425.     [F6]       Increase blue content of picture.
  426.     [F7]       Decrease contrast of picture (VGA only).
  427.     [F8]       Increase contrast of picture (VGA only).
  428.     [F9]       Decrease brightness of picture (VGA only).
  429.     [F10]      Increase brightness of picture (VGA only).
  430.     [Alt-F10]  Restore original palette after you thoroughly mess up the colors.
  431.     [V]        Reverses the current palette (16/64 EGA only); interesting effect
  432.                especially for black & white images.
  433.  
  434.     After a little experimenting, a 'washed out' VGA picture can be greatly
  435.     improved by using [F1-F10] , and you can always start over by using
  436.     [Alt-F10]. To retain a black background in a VGA picture, the brightness
  437.     should be decreased when the contrast is decreased. If you have really
  438.     improved the picture, you can then save it any of the supported formats.
  439.     VPIC will prompt you if the file exists in the default directory, and you
  440.     have the option of overwriting it or giving a new filename. This works
  441.     really well with images created on the Sharp, Howtec or Targa scanners.
  442.  
  443. All other keys are ignored. Pressing [Ctrl-Break] or [Ctrl-C] will go to DOS.
  444.  
  445. DECODING OTHER FILE FORMATS
  446.  
  447. The file decoding works in whatever mode you are presently using (VGA or EGA)
  448. and at the resolution you are viewing with. This way, if you choose to save to
  449. another file format, it will be in the same mode you are viewing with (EGA,
  450. MCGA, VGA, or SuperVGA). The decoding for other than GIF is not as fast as could
  451. be done, but the added versatility more than compensates for this. For example,
  452. EGA PCX files can be very quickly decoded to EGA, but are in the wrong format
  453. for VGA, and considerable manipulation is required to produce a VGA image. For
  454. all formats except GIF, the method of viewing is to decode to a buffer for a
  455. single line at 1 byte/pixel, then copy this line to the display in whatever mode
  456. you are using. This is a compromise for most file formats, since they are geared
  457. to EGA or VGA, and display time suffers, but it makes the code much simpler.
  458. Besides, the other formats are supported mainly to allow easy conversion to GIF,
  459. which is the preferred format for storage, since it gives the smallest file
  460. size. This will also make EGA <-> VGA conversions possible, which is not
  461. supported by most paint programs.
  462.  
  463. The TARGA viewing uses a fixed palette to speed up the decoding, so the picture
  464. does not have what could be called good color. It is mainly there to verify that
  465. an image is present. Use Image Tools TGAPIC to get an equivalent GIF picture
  466. with excellent color rendition.
  467.  
  468. ADDED FEATURES
  469.  
  470. VPIC is meant to fill a void not covered by paint programs, and to allow very
  471. convenient file viewing and conversion between file formats. It is not meant to
  472. compete with the paint programs, and in general if a paint program does
  473. something well (such as resize a picture to fill the screen or cut out a portion
  474. of the picture), VPIC will not attempt to do it. On the other hand, if you think
  475. of a feature which would enhance VPIC, please let me know, and I will consider
  476. adding it to the program.
  477.  
  478. KNOWN PROBLEMS
  479. 1. The ATI 1024x768x16 mode uses 2 pixels/byte, unlike any other VGA or EGA
  480.    mode. It is supported for most viewing and conversions, but will not view or
  481.    convert to EGA Paint files, ColoRIX EGA files, or Pictor EGA files, since
  482.    these are on an EGA plane basis. The workaround is to use the 800x600x16
  483.    mode.
  484.  
  485. 2. Every now and then the menu does not come back correctly after deleting a
  486.    file. The workaround is to restart VPIC.
  487.  
  488. 3. If you have a board with the Trident TVGA 8900 VGA chip, do not run MAMODE
  489.    before running VPIC, or rum MAMODE 64 if you were in a 128K bank mode.
  490.  
  491. IMPORTANT: Support for boards with other VGA chips: VPIC will support other VGA
  492. boards with extended VGA modes if the owners will write me with the details of
  493. how to set the various modes, and how to bank switch the display memory. Of
  494. course, if you also register VPIC I will give the problem more consideration.
  495.  
  496. The bank switching Info for some of the 'not so common' VGA boards is hard to
  497. come by, and is needed if VPIC is to support extended VGA modes for these
  498. boards. A VGA board needs to bank switch for extended modes because there is
  499. only a 64K window in the PC address space for graphics memory (from A000 to
  500. AFFF), and extended modes require more than 64K of memory; 640x480x256 requires
  501. 307200 bytes of memory, or about 4.7 'banks of 64K'. Bank switching is a means
  502. of mapping the (A000 to AFFF) graphics address space into 64K chunks of actual
  503. display memory. The method of bank switching is determined by the VGA chip used
  504. on the display board, and what I need is info on how to switch banks and how to
  505. set the various modes the board supports. The use of a display board would also
  506. help, since it will allow me to test the program with that display board instead
  507. of 'programming blind'.
  508.  
  509. HOW VPIC OPERATES - VPIC decodes a picture file directly to screen memory on
  510.     your  display card. The other technique is to decode to CPU (normal) memory
  511.     and then copy the picture (or a portion of it) to screen memory. Both ways
  512.     have their advantages and disadvantages.
  513.  
  514. DECODING DIRECTLY TO SCREEN MEMORY (LIKE VPIC).
  515.  
  516. ADVANTAGES -  This method offers the best speed, since it doesn't  have  to  go
  517.     thru the intermediate step of decoding to  CPU  memory first.  It will also
  518.     always decode large pictures,  even above  the  maximum display size. The
  519.     CPU method  usually  doesn't  have  sufficient memory for large pics, like
  520.     1024x768x256, or even  800x600x256 if you have any TSR's in memory; these
  521.     pics require 1 byte/pixel.
  522.  
  523.     The file conversion options uses the current palette data and the current
  524.     data in display memory to make the new file.  Thus,  what you see is what
  525.     you get in a new file format,  in  whatever  mode you are viewing (256 or 16
  526.     color).
  527.  
  528. DISADVANTAGES - Because the picture is decoded  directly to  screen  memory,
  529.     any picture data beyond the right edge of the screen is thrown  away. For
  530.     this reason, you can't  scroll  left  and  right.  VPIC  will continue to
  531.     decode to display memory beyond  the  bottom  of  the screen until:
  532.  
  533.         1.  It runs out of memory, set by BANKS in the  configuration file.
  534.  
  535.         2.  If the card does not  wrap  this  memory  back  onto  the displayed
  536.             screen, like  the Video 7 cards.
  537.  
  538.     Thus, if your display card meets the above criteria,  you will be able to
  539.     scroll up and down.
  540.  
  541.     If the screen doesn't display the whole  picture,  any  converted file will
  542.     be truncated on the right edge to the screen size.
  543.  
  544.     In the SLIDE mode of VPIC, the next picture  is  decoded  to  CPU memory
  545.     while you view the current picture, and then copied to the screen when the
  546.     delay time is up.  If you don't have  enough  CPU memory, you get the
  547.     portion of the picture that VPIC can display.
  548.  
  549. DECODING TO CPU MEMORY FIRST
  550.  
  551. ADVANTAGES - If there is sufficient CPU memory to hold the whole picture (at 1
  552.     byte/pixel), a rectangular area equal to the screen size  can be copied to
  553.     display memory,  which allows you to scroll around  the picture in all
  554.     directions.
  555.  
  556. DISADVANTAGES - If there is not sufficient CPU memory, most of the programs
  557.     will refuse to display the picture.  There is also the wait while  the
  558.     picture is decoded to CPU memory before you get to see it.
  559.  
  560. SHAREWARE
  561.     VPIC is user supported software for the IBM PC.  VPIC is made available for
  562. a free ten day trial period.  If you find this program useful,  you may license
  563. the program for non-commercial use on one machine by sending $15.00 to:
  564.  
  565.      Bob Montgomery
  566.      543 Via Fontana #203
  567.      Altamonte Springs, FL 32714
  568.  
  569. VPIC may be licensed for commercial use on up to 10 computers at a single site
  570. or set of sites for $75.00. A commercial site is defined as a business or
  571. individual using VPIC as part of his business activities.
  572.  
  573. Clubs, schools,  universities and other organizations may license VPIC for
  574. $45.00 per 6 copies.
  575.  
  576. If you use VPIC as part of a commercial demo or as a utility for another
  577. application you must obtain a license from Bob Montgomery, and pay a $1/copy
  578. royalty for each copy shipped.
  579.  
  580. VPIC is copyrighted software, and all rights are reserved.
  581.  
  582. VPIC may not be changed or modified in any way  except by the author.  VPIC may
  583. be freely distributed for the ten day trial period as long as it remains in its
  584. complete form. Regardless of how the copy is obtained, it is requested that
  585. all users comply with the licensing agreement.
  586.  
  587. All warranties are disclaimed, including damage to hardware and/or software from
  588. use of this product. In no event will I be liable to you for any damages,
  589. including lost profits, lost savings or other incidental or consequential
  590. damages arising out of your use or inability to use the program, or any other
  591. claim by any other party.
  592.  
  593. INDIVIDUAL USERS
  594.     You may use all updates free once you have registered VPIC. If you are
  595. already registered for VGIF (any version) you may use VPIC for an additional $5.
  596. I do not send updates, but they are available on most graphics oriented BBS's,
  597. and at Compuserve in DL3 of the PICS forum. As an alternative, you can get VPIC
  598. from me by sending:
  599.     1. $15 VPIC registration fee
  600.     2. $5 for upgrading VGIF to VPIC.
  601.     3. $0 for updates of VPIC.
  602. Please include $5 ($10 outside the USA and Canada) for materials, postage, and
  603. handling on all orders. Thus, 1 = $20/$25, 2 = $10/$15, and 3 = $5/$10 for
  604. domestic/foreign orders. As a bonus; I will fill the rest of the disk with good
  605. pictures. Please specify 360K or 1.2Meg disk (I don't have 3.5" disks) and EGA,
  606. VGA, or SuperVGA (640x480x256, etc) so I'll know what pictures to send. For
  607. foreign orders, please send an International or Postal Money Order, since the
  608. banks here charge $25 collection fee for foreign checks. Even if you can't read
  609. a 1.2 Meg disk, I would reccommend getting VPIC on that size, since you get
  610. about 1 Meg of picture files that way. Then, have a friend (or computer store)
  611. copy the files to 360K disks for you.
  612.  
  613. Data on the various file formats VPIC supports is available free if you request
  614. it with your order, but will use about 200K of disk space.
  615.  
  616. SITE LICENSES
  617. 1.  Your current version of VPIC may be licensed for commercial use on up to 10
  618.     computers at a single site or set of sites for $75.00. A commercial site is
  619.     defined as a business or individual using VPIC as part of his business
  620.     activities.
  621.  
  622. 2.  Clubs, schools,  universities and other organizations may license their
  623.     current version of VPIC for $45.00 per 6 computers.
  624.  
  625. 3.  In any case, if you want an update to the latest version of VPIC, please
  626.     send $5 per copy requested plus $5 ($10 outside the USA and Canada)
  627.     shipping, materials, and handling. If you have registered multiple copies,
  628.     it's less expensive to request just one copy and make additional copies at
  629.     your facility; the VPIC disk is not copy protected.
  630.  
  631. 4.  If you use VPIC as part of a commercial demo or as a utility for another
  632.     application you must obtain a license from Bob Montgomery, and pay a
  633.     $1/copy royalty for each copy shipped.
  634.  
  635. Please use the enclosed registration/order form since it allows me to keep
  636. better records and keep up with the newer VGA boards. 
  637.  
  638. VPIC is copyrighted software, and all rights are reserved. VPIC may not be
  639. changed or modified in any way  except by the author.  VPIC may be freely
  640. distributed for the ten day trial period as long as it remains in its complete
  641. form. Regardless of how the copy is obtained, it is requested that all users
  642. comply with the licensing agreement.
  643.  
  644. All warranties are disclaimed, including damage to hardware and/or software from
  645. use of this product. In no event will I be liable to you for any damages,
  646. including lost profits, lost savings or other incidental or consequential
  647. damages arising out of your use or inability to use the program, or any other
  648. claim by any other party.
  649.  
  650. Contact Bob Montgomery for:
  651.     1. Special versions of VPIC tailored to your application.
  652.     2. Other graphics oriented applications (file conversion, etc).
  653.  
  654. Any suggestions or comments should be mailed directly to me. The following are
  655. graphics oriented BBS's:
  656.  
  657. Compuserve PICS Forum (My ID is 73357,3140)
  658. Tsunami BBS, Half Moon Bay, Calif. (415) 726-2726
  659. PC Rockland, S. Nyack, NY (914) 353-2538 [Freeboard] 1.6 Gbyte Online
  660. Megabyte Image Center     (918) 492-0087 1200/2400/9600 baud USR HST
  661. Event Horizons, Portland OR  (503) 777-1578
  662.  
  663.                 APPENDIX A - REVISION HISTORY
  664.  
  665. History of the original VGIF program.
  666.  
  667. VGIF ver 1.1   1-13-88
  668.     *  Added test for EGA adapter.
  669.     *  Fixed menu colors.
  670.     *  Allow [ESC]ape from marked file viewing.
  671.     *  Added [Ctrl-Break] or [Ctrl-C] exit to DOS anywhere.
  672.     *  Added 'disk full' notification when creating picture file.
  673.     *  Added critical error handler for 'drive not ready' errors.
  674.  
  675. VGIF ver 1.2   1-15-88
  676.     *  Changed name to VGIF.
  677.     *  Slide mode now ignores the end of file mark in slide file, and any key
  678.        will now end slide mode.
  679.     *  Added slides to menu mode if [S] pressed-shows marked files as slides
  680.        until a key is pressed.
  681.  
  682. VGIF ver 1.3   1-21-88
  683.     *  Added better error checking to GIF file decoding. Notifies if bad GIF
  684.        file.
  685.     *  Fixed error reporting bug in single file mode.
  686.  
  687. VGIF ver 1.4   2-9-88
  688.     *  Added instantaneous screen update in slide mode from menu or command
  689.        (SLD) file.
  690.     *  Added the /r option which allows an application program to call VGIF
  691.        to view a file and then regain control.
  692.  
  693. VGIF ver 1.5   3-2-88
  694.     *  Added [PgUp] and [PgDn] keys to scroll by 10 lines at a time.
  695.     *  Added a max pic height of 819 lines so EGA buffer would not overflow.
  696.     *  Greatly improved color reproduction for 'problem' pictures (such as FROG,
  697.        ARCHIT, PUFFIN, VEGTABLE, etc). These pictures typically have more than
  698.        16 colors. Selected colors on basis of frequency of use where possible.
  699.     *  Fixed following bugs:
  700.        1.  Line buffer would overflow into other variables if pic width was
  701.            > 640 pixels, causing strange results.
  702.        2.  Didn't recognize the end of image marker correctly. This would
  703.            cause the palette to change when the image was done.
  704.  
  705. VGIF ver 1.6   3-11-88
  706.     *  Fixed a bug in handling multiple images. First noticed when viewing
  707.        WHIMMI.GIF.
  708.     *  Use same palette for multiple images, and get best color match.
  709.     *  Added [L] and [S] commands while viewing a picture. These allow you to
  710.        create full size paint program files.
  711.  
  712. VGIF ver 2.0   3-26-88
  713.     *  Added the ability to view long GIF files ( > 819 lines) without
  714.        wrapping the display.
  715.     *  Added the [C] and [H] (Dr. Halo) file creation option while viewing.
  716.     *  Added the [L] and [S] prefixes to paint program file creation commands
  717.        while viewing to save long pic files.
  718.     *  Added the Info and Help commands in menu mode.
  719.     *  Deleted the # requirement to specify a directory from the command line.
  720.        The program now looks for a directory which meets the spec on the command
  721.        line. If none is found, it assumes the spec is for a single file.
  722.     *  Added [F1 - F10], and [V] palette control keys while viewing a file.
  723.  
  724. VGIF ver 3.0   5-2-88
  725.     *  Added VGA capability, and support for Tseng extended VGA modes
  726.        (640x480x256 and 800x600x256).
  727.     *  Determines and displays available modes for your system.
  728.  
  729. VGIF ver 3.1   5-11-88
  730.     *  Fixed a bug in dir/file spec from command line. Now accepts
  731.        VGIF d:\dir\*.gif or VGIF d:*.gif, although the [\]*.gif is not required,
  732.        since this is the default filespec.
  733.  
  734.     *  Fixed a bug in forced EGA when doing slides, where an interlaced pic
  735.        displayed at double size would have a 'venetian blind' effect.
  736.  
  737.     *  Changed so pics larger than 320x200 are shown in 640x480 VGA; can get
  738.        800x600 by pressing + key.
  739.  
  740.     *  Note that EGA mode on the Orchid VGA card appears squashed vertically.
  741.        This is normal, and cannot be corrected without reprograming the
  742.        parameters for mode 16, which would change the vertical retrace
  743.        frequency, and probably cause your monitor to roll.
  744.  
  745. VGIF ver 3.2   5-26-88
  746.     *  Added 500 file menu, and assy language text screen updating; now
  747.        super fast.
  748.     *  Fixed a bug which caused the Vega VGA card to hang up.
  749.  
  750. VGIF ver 3.3   6-9-88
  751.     *  Added user spec of video mode for non-Orchid VGA boards.
  752.     *  Added GIF and Pictor save of current screen for VGA/EGA pics.
  753.     *  Added prompts to screen for conversion to other formats.
  754.     *  Removed conversion starting at first visible row-now does whole pic.
  755.  
  756. VGIF ver 3.4   6-23-88
  757.     *  Fixed a bug in the GIF save routine.
  758.     *  Added color, contrast, and brightness adjustment in VGA.
  759.     *  Fixed a bug in menu mode for marked files.
  760.     *  Added /n command line option to stay in 640x480x256 for VGA pics.
  761.  
  762. VGIF ver 3.5   7-14-88
  763.     *  Fixed some misc minor bugs.
  764.     *  Added increase/decrease resolution command while viewing 16 color VGA
  765.        pics (using the /e option).
  766.     *  Added slide mode for VGA.
  767.     *  Added lock mode option to start pics from the menu in a desired mode.
  768.  
  769. VGIF ver 3.6   8-8-88
  770.     *  Fixed some bugs.
  771.     *  Fixed EGA slide show.
  772.  
  773. VGIF ver 3.6A  9-10-88
  774.     *  Fixed 1024x768x16 mode.
  775.  
  776. VGIF ver 4.0   10-20-89
  777.     *  This was a beta test version which got out. It had lots of bugs, which
  778.        were fixed in VPIC.
  779.  
  780. History of VPIC
  781.  
  782. VPIC ver 1.0 & 1.1 12-27-88
  783.     *     Beta test versions.
  784.  
  785. VPIC ver 1.2   12-27-88
  786.     *  Added configuration option for various display boards.
  787.     *  Added VGA file conversion for all previous Paint programs supported.
  788.     *  Added Deluxe Paint 2 conversion.
  789.     *  Added Targa 16 file conversion.
  790.     *  Added EGA/VGA toggle from menu.
  791.     *  Added default resolution select, and Mode Lock key from menu.
  792.     *  Added WAIT option to pause between images of multi-image files.
  793.     *  Added MAC, PCX, & Colorix file viewing capability. Others will be
  794.        added in later versions.
  795.     *  Added 'animate' while viewing.
  796.     *  Fixed VGA 16 color palette.
  797.  
  798. VPIC ver 1.2A   1-4-89
  799.     *  Fixed MAC -> GIF conversion
  800.     *  Fixed CVPIC for ^Z as EOF char.
  801.     *  Fixed 16 color palette for other file formats if VGA 16 colors.
  802.  
  803. VPIC ver 1.3    2-2-89
  804.     *  Fixed cursor in menu.
  805.     *  Fixed 'lock up' if GIF header size wrong (640x350 labeled 350x640).
  806.     *  Now pauses pic if file error and waits for key press-can see partial
  807.        pics in bad files this way.
  808.     *  Shows GIFs with MAC headers (1st 128 bytes are not GIF standard);
  809.        if F3 (info) pressed shows if file has a MAC header.
  810.     *  Fixed so views and saves new ZSoft VGA PCX files which include
  811.        palette at end of file. Still doesn't load PAL files.
  812.     *  Fixed ZSoft file displays and saves.
  813.     *  Added Wait toggle (F8) which pauses between images in multi-image
  814.        GIFs, and allows conversion to other filetypes.
  815.     *  Made MACs black on bright white instead of gray.
  816.  
  817. VPIC ver 1.4   3-15-89
  818.     *  Added printout of filename while decoding except in slide mode.
  819.     *  Added help while viewing a picture; press [?] or [/].
  820.     *  Added delete a file option [X] (with query) while viewing.
  821.     *  Added hit [ESC] while decoding to abort picture.
  822.  
  823. VPIC ver 1.5   3-23-89
  824.     *  Fixed bug in 'Escape while decoding' which would hang system.
  825.     *  Fixed EGA x2 display for interlaced files.
  826.     *  Fixed problem with saving a pic after scrolling.
  827.     *  Fixed palette in animate, so save will use current palette.
  828.     *  Fixed problem with bad files in slide mode that would hang computer.
  829.     *  Fixed error display in /@ slide mode and single file mode.
  830.  
  831. VPIC ver 1.6   4-5-89
  832.     *  Fixed bugs in slide show from command file. Added comments.
  833.     *  Added resolution option for each picture in slide command file.
  834.     *  Fixed miscellaneous minor bugs.
  835.     *  Added configurable menu color.
  836.  
  837. VPIC ver 1.7   6-13-89
  838.     *  Added Trident chip set support (for Maxxon and Logix VGA boards
  839.        and maybe the ATI board).
  840.     *  Fixed a few bugs concerned with putting & getting lines from the
  841.        display screen.
  842.     *  Fixed problem with Ctrl Z at end of slide definition file.
  843.  
  844. VPIC ver 1.8  6-28-89
  845.     *  Added EGA Paint viewing/conversion.
  846.     *  Fixed conversion to 800x600 ColoRIX file.
  847.     *  Fixed other minor bugs.
  848.  
  849. VPIC ver 1.9  7-19-89
  850.     *  Added inverted, mirrored, and rotated GIF saves.
  851.     *  Fixed a bug in the Dr Halo CUT file creation.
  852.     *  Added menu updating after file creation or deletion.
  853.     *  Added new path spec feature from menu with [F9] key.
  854.  
  855. VPIC ver 2.0  8-6-89
  856.     *  Added Pictor/PC Paint PIC, Dr. Halo CUT, Deluxe Paint LBM, and
  857.        Targa 16 or 24 file viewing capability.
  858.     *  Fixed a bug in the palette selection for EGA.
  859.     *  Fixed a bug which would not show VGA for the plain vanilla VGA config.
  860.     *  Fixed a bug in the ZSoft PCX display for extended EGA modes.
  861.     *  Added Auto resolution option and switch from the menu [F7].
  862.     *  Made cursor stay fixed when files are created or deleted.
  863.     *  Added Chips & Technology support. (VPIC 2.0A)
  864.     *  Fixed ZSoft save at higher screen resolution than pic. (VPIC 2.0B)
  865.  
  866. VPIC ver 2.1   9-5-89
  867.     *  Fixed a bug in LBM viewing
  868.     *  Added ColoRIX 16 color SCR and SCP view/create.
  869.     *  Speeded up GIF decoding about 50%.
  870.  
  871. VPIC ver 2.1A  9-10-89
  872.     *  Fixed a memory allocation problem for slides.
  873.     *  Made small increase in speed.
  874.     *  Fixed directory callout (*.PIC, etc).
  875.     *  Re-enabled [ESC] for GIF viewing.
  876.     *  Fixed Chip & Tech bank switching routine.
  877.     *  Fixed Deluxe Paint II (LBM) file creation.
  878.  
  879. VPIC ver 2.2  10-23-89
  880.     *  Fixed problem in new path command ([F9] from menu).
  881.     *  Fixed intermittent GIF decode problem.
  882.     *  Program now tells if GIF image and screen sizes conflict.
  883.     *  Menu now correctly displays file sizes larger than 1 Mbyte.
  884.     *  Now lists & displays Electronic Arts IFF files (same as LBM).
  885.  
  886. VPIC ver 2.3  12-13-89
  887.     *  Fixed C_T bank switching.
  888.     *  Added Everex 678, Ahead (B chip), and Genoa 6400 support.
  889.     *  Fixed bugs in GIF and Pictor decoder.
  890.  
  891. VPIC ver 2.4  12-28-89
  892.     * Fixed bug in GIF decoder for very wide pics.
  893.     * Fixed palette for many file types.
  894.     * Fixed slide mode from menu.
  895.  
  896. VPIC ver 2.5  1-28-90
  897.     * Fixed single file and /r modes.
  898.     * Fixed Pictor viewing for B&W pics.
  899.     * Fixed MAC header interpertation problem.
  900.     * Fixed memory clearing for pictures longer than the screen.
  901.     * Added F10 to menu to display current path. Menu no longer shows
  902.       complete path (only filespec) to avoid clutter with long paths.
  903.     * Deleted path from filename display when showing picture.
  904.     * Added SCY conversion for ColoRIX.
  905.     * Added Zymos VGA chip support.
  906.     * Corrected CVPIC to allow more than 9 banks in config file.
  907.  
  908. VPIC ver 2.6  1-28-90
  909.     * Fixed palette for 2 color GIFs.
  910.     * Fixed SCU display in 1024x768x16 mode.
  911.     * Fixed Pictor EGA and ColoRIX EGA slide viewing.
  912.  
  913. VPIC ver 2.7  3-17-90
  914.     * Fixed GIF bug and palette for files with local color maps.
  915.     * Added /b command line option to beep after a picture is decoded except
  916.       in slide modes.
  917.     * Added Alt_F command while viewing a picture to momentarily display the
  918.       file name.
  919.     * Fixed Targa viewing for all sizes; now handles RLE images too.
  920.  
  921. VPIC ver 2.8  3-27-90
  922.     * Added /h command line option to find hidden files.
  923.     * Changed menu display to allow up to 8 modes for VGA or EGA.
  924.     * Fixed palette in Dr. Halo CUT files.
  925.     * Added Tseng 4000 chip support.
  926.  
  927. VPIC ver 2.9  5-23-90
  928.     * Fixed Targa module to handle all 8 thru 32 bits/pixel formats.
  929.     * Added copyright messages.
  930.     * Fixed PCX viewing for gray scale files.
  931.  
  932. VPIC ver 2.9A 7-1-90
  933.    *  Fixed Targa module for files which don't follow the compression rules
  934.       of 'don't overrun lines'. Added TGA expand option [E] while viewing a
  935.       RLE compressed Targa file.
  936.    *  Fixed conversion routines so they save the pictures size. This was a bug
  937.       that crept into ver 2.9.
  938.    *  Added ESC to abort deleting a file with [Alt_X].
  939.    *  Added file types (where applicable) to the info command [F3] from the
  940.       menu.
  941.    *  Added uncompressed ColoRIX SCO file (1024x768x256) support.
  942.    *  Fixed a bug in CVPIC.
  943.    *  Fixed a bug which prevented working with DOS 4.x.
  944.    *  Added Deluxe Paint II enhanced viewing and save capability.
  945.    *  Fixed a color bug in Targa 32 viewing.
  946.  
  947. VPIC ver 3.0  9-15-90
  948.    *  Added capability to view the new GIF89a files, and FRA fractal files.
  949.       Added delay and user response features of GIF89a.
  950.    *  Fixed a bug which would hang the computer if you deleted the last
  951.       viewable file from a directory.
  952.    *  Added prompt for a file conversion, allowing you to escape.
  953.    *  Added C&T, as well as the previous C_T, which VPIC will accept as the
  954.       Chips & Technologies VGA chip in the config file.
  955.    *  Fixed memory allocation bug in PCX creation for 1024x768x256 images.
  956.  
  957. VPIC ver 3.1  9-25-90
  958.    *  Added flexibility to slide mode. Always decodes to memory and can change
  959.       delay for files; see the section on 'vpic /@slidesfile`.
  960.  
  961. VPIC ver 3.2  10-29-90
  962.    *  Fixed the bank switching for the Trident 8800 chip.
  963.    *  Fixed a palette problem when viewing Targa files.
  964.  
  965. VPIC ver 3.3  11-5-90
  966.    *  Fixed problem with lines on VGA pics in slide mode.
  967.    *  Added animate command in slide command file, and speed control for
  968.       animation.
  969.    *  Fixed MCGA 16 color palette.
  970.    *  Fixed ATI 1024x768x16 slide mode.
  971.  
  972. VPIC ver 3.4  11-21-90
  973.    *  Fixed most conversion routines so they work in ATI 1024x768x16 mode;
  974.       can't do EGA Paint or 16 color ColoRIX, or Pictor EGA files.
  975.    *  Fixed most viewing routines so they work in ATI 1024x768x16 mode;
  976.       can't do EGA Paint or 16 color ColoRIX, or Pictor EGA files.
  977.    *  Fixed bugs in conversion for pics less than screen width wide.
  978.    *  Cleaned up numerous small bugs.
  979.    *  Added BIF Binary Image File from B&W image capture boards.
  980.  
  981. VPIC ver 3.5  12-15-90
  982.     *  Added 64 shade gray conversion for VGA images (press b while viewing).
  983.     *  Added auto-centering for pictures smaller than the screen.
  984.     *  For slides, now displays as much of picture as memory will allow.
  985.  
  986. VPIC ver 4.0  02-13-91
  987.     * Added GIF89a features including transparent color, variable size plain
  988.       text, user input, variable delay, and display of comments. Works in all
  989.       EGA and VGA modes.
  990.     * Fixed all file conversions so they work with centered images.
  991.     * Improved palette selection, and made hi contrast help messages.
  992.